home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / italia / x-trash.lha / X-Trash / X-Trash.doc < prev    next >
Text File  |  1996-01-30  |  13KB  |  374 lines
  1.  
  2.  
  3.  
  4.             ====================================
  5.  
  6.                     X-Trash v1.3
  7.  
  8.               The trashcan maintenance utility
  9.  
  10.              © 1994-96 by Rudi Chiarito
  11.  
  12.             ====================================
  13.  
  14.  
  15.  
  16. Contents
  17. ^^^^^^^^
  18.  
  19. 1. Introduction
  20.  
  21. 2. Usage
  22.  
  23. 3. Odds and ends
  24.  
  25. 4. Program history
  26.  
  27.  
  28.  
  29.        * · * · * · * · * · * · * · * · * · * · * · * · * · *
  30.  
  31.  
  32. /* *\
  33. * 1 *   Introduction
  34. \* */  ^^^^^^^^^^^^^^
  35.  
  36.  
  37.  1.1. Preface
  38. ^^^^^^^^^^^^^^
  39.  
  40.   The programs and files in this distribution are FREEWARE. That is: they
  41. are copyright © Rudi Chiarito, but they may be freely distributed as long as
  42. no more than a nominal fee is charged to cover distribution costs. Moreover
  43. they can't be distributed separately or in a commercial package without
  44. written permission from the author. That's all.
  45.  
  46.  1.2. I'm Trash, X-Trash
  47. ^^^^^^^^^^^^^^^^^^^^^^^^^
  48.  
  49.   How many Amigans actually use the notorious Trashcan? Is it any good? As
  50. to me, I could have been using it the first two-three times I toyed around
  51. with my old, luxuriant A500; i.e., a long long long time ago.
  52.  
  53.   It's unlikely a coincidence that hardly anybody uses the Trashcan drawer
  54. on the Amiga. Its use is anything but handy and here are some of the
  55. reasons:
  56.  
  57.   · Unlike the Mac, Amiga places the Trashcan drawer in the disk's root
  58.      directory window (it would be far better if it could be left out)
  59.   · A Trashcan is tied to the volume it is on: there must be a Trashcan for
  60.      each of the mounted volumes
  61.   · As a consequence, if you drag (e.g.) "Antani:Blinda/Patuo/Cuda" in the
  62.      "Work:" Trashcan, it will simply be copied to the "Work:Trashcan"
  63.      drawer, instead of being moved to "Antani:Trashcan/Cuda".
  64.   · If (e.g.) you need to empty the "Work:" Trashcan, you'll have to open
  65.      the root directory window of "Work:", click on "Trashcan" and then
  66.      select the menu item "Icons/Empty trash..."
  67.   · After all, many people have got used to live without the Trashcan,
  68.      simply by deleting the file(s)
  69.  
  70.   Have you got enough of it? Never mind: X-Trash is here (to stay!). If you
  71. would like to use the Trashcan without worries, this brilliant program will
  72. be the answer to all of your needs (at least that's what I hope).
  73.  
  74.  
  75. /* *\
  76. * 2 *   Usage
  77. \* */  ^^^^^^^
  78.  
  79.  
  80.  2.1. Requirements
  81. ^^^^^^^^^^^^^^^^^^^
  82.  
  83.   X-Trash has no special requirements: it needs 2.0+ OS and reqtools.library
  84. V38+ (by Nico François). Since it adds an AppIcon and an AppMenu to the WB,
  85. it also needs the Workbench to be running at launch [lunch? :)] time.
  86. As of v1.1, it also supports localization.
  87.  
  88.  2.2. Installation
  89. ^^^^^^^^^^^^^^^^^^^
  90.  
  91.   Pretty tricky, this. Just drag the icon wherever you want. That's all. In
  92. order to have the program running automatically upon every reboot, move the
  93. icon into the WBStartup drawer. If you're using locale.library copy the
  94. catalog(s) file you need in the Locale:catalogs/<language> drawer. Maybe
  95. version 2 will feature an installation script :).
  96.  
  97.  2.3. Getting started
  98. ^^^^^^^^^^^^^^^^^^^^^^
  99.  
  100.   When run, X-Trash will show up a new, gaudy, icon in the main Workbench
  101. window. Drop the icons you want to get rid of on it: you can use multiple
  102. selection, if you want. It will also accept icons from different drawers/
  103. volumes. Icons will then be moved from their original place to the
  104. correspondent Trashcan.
  105.   Dropping volume icons will result in executing the correspondent command
  106. defined with tooltypes. Futher information below.
  107.  
  108.   Try and have a good look at the "Tools" menu. You should notice a new
  109. item, called "Empty trashcan(s)...". Select it and a requester will pop up
  110. asking you how many trashcans you're going to flush.
  111.  
  112.   · "All"
  113.  
  114.   · "Select..."
  115.      If there are any volumes whose Trashcans are NOT EMPTY,  it'll pop up a
  116.      volume requester, which will show you ONLY SUCH volumes. Choose the
  117.      one whose Trashcan you want to flush. It will carry on asking you
  118.      volumes until all the Trashcans are empty or until you enter an empty
  119.      string, close the window or select the "Cancel" gadget.
  120.  
  121.   · "Icons"
  122.      If you've selected one/more volume icons, it'll empty the correspondent
  123.      Trashcan(s). It ONLY WORKS WITH VOLUME ICONS: directories or files just
  124.      won't do!
  125.  
  126.   · "Cancel"
  127.      Aborts requester
  128.  
  129. Double-click on the AppIcon and another request will appear (it also pops up
  130. when you try to run X-Trash again while it is still running)
  131.  
  132.   · "Empty..."
  133.      Makes the other requester appear.
  134.  
  135.   · "About..."
  136.      Gives you information about X-Trash.
  137.  
  138.   · "Quit"
  139.      Quits X-Trash.
  140.  
  141.   · "Cancel"
  142.      Aborts requester
  143.  
  144. Now X-Trash can also be quitted by sending it a CTRL-C signal (you can also
  145. use the BREAK command, if X-Trash has NOT been run from Workbench/WBStartup.
  146. Otherwise you need a system monitor like ARTM or a Shell command like
  147. BreakTask -- which is part of the 3.1 Developer Kit, archive DevTools.lha).
  148.  
  149. NOTEZ BIEN: At the moment WB seems to get confused when a file without the
  150. .info file has been modified, moved or deleted and the menu item
  151. "Windows/Show/All files" is selected. Such a 'bug' (it never crashes the
  152. machine, though) is more evident if you're using Release 2.0... WB 3 has a
  153. smarter approach. Anyway fake icons should appear only if you have Trashcan
  154. subdirectories opened. Selecting the menu item "Windows/Update" should
  155. get rid of them.
  156.  
  157.  2.4. Tool Types
  158. ^^^^^^^^^^^^^^^^^
  159.  
  160.   Version 1.1 adds support for two Tool Types:
  161.  
  162.    · CONFIRM
  163.      If set to YES, X-Trash will ask you for a confirmation before flushing
  164.      a Trashcan. If set to ALWAYS, it will do it for EVERY sub-directory.
  165.      Defaults to NO.
  166.  
  167.    · PROTECT
  168.      If set to ASK, X-Trash will ask you for a confirmation before resetting
  169.      delete-protection on a file/directory.
  170.      IF set to YES, it will always make sure the file/drawer is delete-able.
  171.      Defaults to NO.
  172.  
  173.   Version 1.3 adds EIGHT more Tool Types:
  174.  
  175.    · TITLE
  176.      Name of the AppIcon. Defaults to "X-Trash".
  177.  
  178.    · XPOS
  179.      X coordinate of the AppIcon.
  180.  
  181.    · YPOS
  182.      Y coordinate of the AppIcon.
  183.  
  184.    · NOLOCALE
  185.      If present, X-Trash will not attempt to open locale.library and the
  186.      catalog file.
  187.  
  188.    · DRAWER
  189.      Name of the trashcan directories to create/move_files_to/flush. It
  190.      could be 'Cestino' for italian users, for example. Defaults to
  191.      'Trashcan'.
  192.  
  193.    · DROPSOUND
  194.      Full path name of the sample to be played when moving files to the
  195.      trashcan(s). It needs WB3+ to work, as it uses datatypes.library.
  196.      Defaults to no sound.
  197.  
  198.    · FLUSHSOUND
  199.      Full path name of the sample to be played when flushing the trashcan(s)
  200.      drawer(s). It needs WB3+ to work, as it uses datatypes.library.
  201.      Defaults to no sound.
  202.  
  203.    · DROP[device/volume]
  204.      AmigaDOS command to be launched (asynchronously) when a VOLUME icon is
  205.      dropped on X-Trash's one. Defaults to no command.
  206.      Suppose you have a dh7: hard disk whose name is 'Sushi'. When you drop
  207.      its icon on X-Trash's, the program will search (in order) tooltypes
  208.      'DROPDH7', 'DROPSUSHI', 'DROP'. Please note the missing trailing colon
  209.      (DH7 instead of DH7:). The first one to be found (if there are any)
  210.      will be executed. Occurrencies (max. 4) of "%s"s in the tooltype will
  211.      be replaced by the DEVICE NAME.
  212.      It could be handy for ejecting/formatting removable medias (CD-Roms
  213.      or ZIP drives, for istance). Feel free to let me know if you have
  214.      brightest ideas. 8)
  215.  
  216.      For example, the tooltype
  217.  
  218. *     DROPSUSHI=list "%s:" all dirs >CON://///CLOSE/WAIT
  219.  
  220.      would have made X-Trash run
  221.  
  222. *     list "DH7:" all dirs >CON://///CLOSE/WAIT
  223.  
  224.      While the tooltype
  225.  
  226. *     DROPSUSHI=list "%s:Trashcan" >CON://///CLOSE/WAIT
  227.  
  228.      would have made X-Trash run
  229.  
  230. *     list "DH7:Trashcan" >CON://///CLOSE/WAIT
  231.  
  232.      (It shows the contents of the Trashcan in a console window)
  233.  
  234.      Always remember to put the trailing colon in the command string!!! It
  235.      is also a wise idea to put the %s string between (double) quotation
  236.      marks.
  237.  
  238. /* *\
  239. * 3 *   Odds and ends
  240. \* */  ^^^^^^^^^^^^^^^
  241.  
  242.  
  243.  3.1. X-Trash: the making
  244. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  245.  
  246.   Up to v1.2, X-Trash was written using the mighty AmigaE v3.1 by Wouter van
  247. Oortmerssen. I wrote the Assembly port but the source was strangely hiding
  248. itself somewhere... So I had to port it once again :( Now v1.3 is 50% the
  249. size of v1.2, plus it's FASTER and adds some new features!!!
  250. If you have translated the catalog file, please send it to me: it will be
  251. included in the next release!
  252.  
  253.  
  254.  3.2. Acknowledgements
  255. ^^^^^^^^^^^^^^^^^^^^^^^
  256.  
  257. I would like to thank...
  258.  
  259.  · Commodore-Amiga and Amiga Technologies...
  260.  · Wouter van Oortmerssen...
  261.  · Nico François...
  262.  · Luca Viola for his Amiga (and also his patience!)
  263.  · Marco Musso, Danny Amor, Michael Ostergren, Sten Bredenberg, Stanislav
  264.    Brabec, Marcin Orlowski, Giuseppe Ghibò...
  265.     Suggestions and locale catalogs
  266.  · Cinzia Montuori...
  267.     Unconscious bug-fixing suggestions! (she's NOT my girl/woman/wife!)
  268.  · Sting, D. Fagen, Queen, D. Bowie, G. & P. Conte, Yes, Bangles, INXS, Elio
  269.    e le storie tese, Dire Straits, Cure, D. Byrne, W.A. Mozart, B52's, Toto,
  270.    L. Dalla, The Who, J.M. Jarre, Fleetwood Mac, L. van Beethoven...
  271.  · D. Adams, M. Serra, K. Vonnegut, A. Rice, E. Queen, H. Hesse...
  272.  · Elaine...
  273.     Kimi wa kizi o kaita ka... tonikaku watasi wa kimi o ai suru!
  274.  
  275.   Their contribution has been invaluable to the development of this program!
  276.  
  277.  3.3. Future improvements
  278. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  279.  
  280. "If it's a future world we fear
  281.  We have tomorrow's seeds right here
  282.  For you can hold them in your hand
  283.  Or let them fall into the sand"
  284.                  - Sting
  285.  
  286.   Here's what I'm working on, anyway.. These features will be part of V2 :)
  287.   · An Installer script
  288.   · Faster Trashcan flushing: use of ExAll() rather than Examine()/ExNext()
  289.   · Support for commodity.library
  290.   · 
  291.  
  292.   Any suggestions, as usual, would be very appreciated. Meanwhile *please*
  293. also check its stability and let me know about it...
  294.  
  295.  
  296.  3.4. The author
  297. ^^^^^^^^^^^^^^^^^
  298.  
  299.   This program is FREEWARE. I don't ask anything, but if you like, you can
  300. send me PD programs, sources, money (why not?) or anything you can think of
  301. (I'd like to receive sweetmeats, anyway). Oh, yes, you can send me nice
  302. postcards, too.
  303.   Here's my address... of course you can also send me suggestions, comments,
  304. questions, bug reports (Aaaaargh! God Forbid()!) and gossips! Email is far
  305. better: I study in Pisa (550kms from home) and most of the time I'm there.
  306. As if it weren't enough, mail delivery in Italy is sooooo sloooooooooooow...
  307.  
  308. SnailMail:    Rudi Chiarito
  309.         Via Malpighi, 8
  310.         I-80014 Giugliano (NA)
  311.  
  312. E-Mail:        chiarito@cli.di.unipi.it
  313.  
  314. WorldWideWeb:    http://www.cli.di.unipi.it/~chiarito/
  315.  
  316. IRC:        Nutello
  317.  
  318.  
  319. (Ooops, I almost forgot: excuse me for my English!!!)
  320.  
  321.  
  322. /* *\
  323. * 4 *   Program history
  324. \* */  ^^^^^^^^^^^^^^^^^
  325.  
  326. ****************************************************************************
  327. *  v. 1.00  [1.000] - 27/06/94 - First public release!!!           *
  328. *  · Code cleanup.                               *
  329. *  · Fancy icon (by Michele) added. Don't put the blame on me!           *
  330. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  331. *  v. 1.1   [1.042] - 13/7/94 - First public update!!!               *
  332. *  · Added CONFIRM and PROTECT Tool Types support.               *
  333. *  · Improved WB icon update upon deletion.                   *
  334. *  · Added locale.library support                       *
  335. *  · New icon design. Now you can put the blame on me...           *
  336. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  337. *  v. 1.1+  [1.043] - 26/2/95                            *
  338. *  · Recompiled using AmigaE v3.0a. Program size is 1400 bytes shorter!!!  *
  339. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  340. *  v. 1.2   [1.045] - 13.6.95                            *
  341. *  · Removed a nasty BUG which appeared when CONFIRM was set           *
  342. *  · Now adds just ONE AppMenu which pops up a requester           *
  343. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  344. *  v. 1.3ß  [1.067] - 13.10.95                            *
  345. *  · Ported to Assembly 8)                           *
  346. *  · Added icon name/position/nolocale tooltypes               *
  347. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  348. *  v. 1.3ß+ [1.073] - 16.11.95                            *
  349. *  · Added drawer name/sound/volume drop action tooltypes           *
  350. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  351. *  v. 1.3ß++[1.074] - 17.1.96 [My birthday! 8)]                *
  352. *  · Removed a VERY NASTY BUG which had never hurt anyone, though 8)       *
  353. *  · The executable file can be renamed now                   *
  354. *  · Quits if BREAK (CTRL-C) signal is received                   *
  355. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  356. *  v. 1.3   [1.075] - 29.1.96                            *
  357. *  · Volume requester appears ONLY if one or more trashcans are not empty  *
  358. *  · Ready for public release! Delays are due to the new HD I've bought       *
  359. *    [I had lost some of the include files :(]                   *
  360. ****************************************************************************
  361. * akes it possible! Only Amiga makes it possible! Only Amiga makes it poss *
  362. ****************************************************************************
  363.  
  364.        * · * · * · * · * · * · * · * · * · * · * · * · * · *
  365.  
  366.  
  367. "Per fortuna che c'è uno                   · ***   · ***
  368.  Legge solo la Sacra Bibbia                  · * · * · * · *
  369.  Ore ed ore, notte e giorno                 · *     · *  · *
  370.  Ha un'indice d'ascolto fra i più bassi             · *    · * · ** 
  371.  Ma pazienza..."                      · *  · *    · * 
  372.                                · ****      · **
  373.   - Giorgio Conte & Elio e le Storie Tese
  374.